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OPCDEFTMP.SDL = temporary system definition file for OPCOM internal structures 


Version: *v04-000' 


LARRRRARRAAAALALELA LALLA ALE SELES ESE LEER SEER EERE ESE SCE REECE CECE CERES SESE SY 


COPYRIGHT (c) 1978, 1980, 1982, 1984 BY 
DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASSACHUSETTS. 
ALL RIGHTS RESERVED. 


® 
* * 
® & 
* ® 
® ® 
& ® 
* THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED * 
* ONLY IN ACCORDANCE WITH R F SUCH LICENSE AND WITH THE ® 
* INCLUSION OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER * 
* COPIES THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY * 
* OTHER PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY * 
* TRANSFERRED. * 
* + 
* THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE * 
* AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT * 
* CORPORATION. . 
® * 
® * 
* ® 
* ® 
tr ® 
® ® 


DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS 
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL. 
PARAAAALALALELALLLALLESESSE EEA SEES EEE SESE SESE SERRA ERR EERE RES EE SEE ESSERE EASY 
++ 
FACILITY: OPCOM = Operator Communications 
ABSTRACT: 
This file contains the SDL source for OPCOM internal structure 
definitions. These are temporary structures which are Likely 
to change soon. 
AUTHOR: CW Hobbs CREATION DATE: 28-Jun-1983 
MODIFICATION HISTORY: 
V03-004 CWH3169 CW Hobbs 5-May-1984 
Second pass for cluster-wide OPCOM: 
- Add shutdown cluster message type and structure. 
- Bump software version number 
v03-003 RSHO111 R. Scott Hanna 12-Mar-1984 
Define a grates for the maximum formatted message 
size. (OPCSK_MAXMESSAGE) 
V03-002 CwH3002 CW Hobbs 16-Sep-1983 
Add CLM__CLUMBX message type 


ule OPCDEF TMP; 
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/* 
/* 
/* 
cons 


cons 


/t 
/* T 


K 3 


/* operator scope definitions, do one set with ‘kK’ tags and one set with 


tant ( 
SYSTEM, 
GROUP, 


USER 
UNSPEC 
) equals 1 increment 1 prefix OPCS tag ‘'k"’; 


tant ( 
SYSTEM, 


USE 
UNSPEC 
) equals 1 increment 1 prefix OPCS tag ‘'C''; 


he version number constant loosely describes the generation number of 


/* OPC 


/*d 
/*¢ 


/* diff 


/*h 
/* 
cons 
/* 
/* 
/e 
cons 
cons 


cons 
cons 


/t 
/* D0 
/t 
cons 


PCOM. This number would be man ly bumped at significant times in the 
evelopment cycle of OPCOM. It should be used to detect (and hopefully 
ope) with the situation of different versions of OPCOM executing on 
erent nodes of a cluster. OPCOM cluster-wide data structures also 
ave version numbers. 


tant OPCSK_SW_VERSION equals 9; 


iscellaneous numbers 
tant OPCSK_MAXREAD equals 2560; 
tant OPCSK"MAXMESSAGE equals 2046; 


tant OPCSK_COMHDRSIZ equals 3 
tant OPC$_OPCOMERROR equals 99599; /* New error message 


efine message codes for new format messages 
tant ( 
/t 


/* New format analogs to old messages. These aight be referenced by other facilities, 
~ so changing the values requires a system build. 


OPRENABLE, 


LOGFILE, 
areveees 


HUTDOWN 
TIMESTAMP, 
SECURITY, 
a Request codes for cluster communication messages 

SEP-1984 23:06:31.29 SDL_V2.0 Page 3 
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CLUSASG. 

/* Define special debugging code 


/* 

gees. 

mM Connection manager messages 

ee, 

a Dummy code to receive highest legal value + 1 


REQUEST_END_MARK 
) equalS 10°increment 1 prefix OPC$_ tag ‘'x"'; 


/* 
. Define secondary message codes for inter-node cluster messages 
constant ( 

/* 


ACKNOWLEDGEMENT /* Response to acknowledge request 
ACKNOWLEDGE _PLEASE, /* Request for remote node to announce itself 


CAN /* Explicit cancel of request 

CHECK_OPERATOR, /* Make sure this operator is in the database 

CHECK REQUEST, /* Make sure a request is in the database 

CLUMBR /* Cluster mailbox message passed from cnxman 

CLUSTER, /* Cluster status change report 

DEVICE, /* Device message (on-line, off-line etc) 

IMP_CANCEL /* Implicitly cancel a request 

IMP~DISABLE, /* Implicitly disable an operator 

OPRENABLE, /* Tell everyone else to enable or disable an operator 
REPLY, /* REPLY /PEND etc command 

REPLY COMPLETE, /* Operator request completed by operator 

REQUEST, /* Operator request 

RPYBRD, /* Message from OPCOM to remotes, info for cluster REPLY /TERM, etc 
RPYBRD_LOCAL, /* Broadcast message from REPLY to OPCOM on local node 
RPYNOT /* Reply notifications 

SECURITY, /* Security alarm from remote 

SHUTDOWN, /* Shut down operations 


/ 
~ Dummy code to receive highest legal value + 1 


REQUEST_END_MARK 
) equalS 1 increment 1 prefix CLM_ tag ‘"’; 


— — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — — 
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160 * 

161 /* loagorary macro definitions for macros that will Later be 

166 /* defined in the SOPCDEF macro. These are the offsets for the 

16 /* various message formats. 

164 /* 

165 

166 /* 

16 /* Define the request header. All messages (with the exception 

188 a of the device on/offline messages) have a common header. 

e 

170 

171 aggregate HEADER_MESSAGE structure prefix OPCS fill; 

3 ROSTCODE yte unsigned; /* Request code 

17 8 byte 238 /* Request SCOPE , 

174 OPTIONS tLongword unsigned; /* Request independent option bits. 

175 RQ_OPTIONS longword unsigned; /* Request dependent options 

176 ATTNMASK1  longword unsigned; /* Attention mask part 
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; 
; 
; 
; 
; 
; 
: 
; 


m 3 


ATTNMASK2 lLongword unsigned; /* Attention rs be part 2 
RQSTID Longword unsigned; /* User specified request id # 
lLongword unsigned; /* UIC of requestor 


constant HDR SIZE equals .; /* Size of common header 
end HEADER_MESSAGE; 


./t 
/* Option bits are carried around inside various structures. Therefore, it 

/* is more convenient to define them against the start of a longword, rather 
8 than as a byte offset inside a structure. 


aggregate HEADER_OPTIONS structure longword unsigned prefix OPC$ fill; 


/* 
* Define request independent option longword and bits. 


NOLOG bitfield mask; /* Do not log the action 

NOBRD bitfield mask; /* Do not broadcast 

end HEADER_OPTIONS; 
15-SEP-1984 23:06:31 
15-SEP-1984 22:48:05 


/* 
8 Define OPRENABLE message fields. 


aggregate OPRENABLE_MESSAGE structure prefix OPCS fill; 
OPRENABLE _F ILL byte dimension OPCSK_HDR_SIZE fill; 


/t 
Define place for the trailer message 


OPRENABLE_OPR character Length 0; /* § 
constant OPRENABLE_MIN_SIZE equals . + 4; /* M 


end OPRENABLE_MESSAGE; 
aggregate OPRENABLE_OPTIONS structure longword unsigned prefix OPCS fill; 


fers of oper dev name 


/t 
8 Define request dependent option bits. 
DISABLE bitfield mask; 
PERMOPER bitfield mask; 
NOREMIND bitfield mask; 
E 


end OPRENABLE _OPTIONS; 


/t 
Define LOGFILE message fields. 


aggregate LOGFILE_MESSAGE structure prefix OPCS fill; 
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nm message size header + 4 


LOGFILE_FILL byte dimension OPCSK_HDR_SIZE fill; /* Skip to request dependent options 


/t 
/* Define place for the trailer message 
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/* 
LOGFILE_OPR character Length 0; /* § 
IZE equals . + 4; /* 


constant LOGFILE_MIN_S 


end LOGFILE_MESSAGE; 
aggregate LOGFILE_OPTIONS structure longword unsigned prefix OPCS fill; 


/* 
. Define request dependent option bits. 


INITLOG bitfield mask; 
CLOSELOG bitfield mask; 
DISABLOG bitfield mask; 
ENABLOG bitfield mask; 


end LOGFILE_OPTIONS; 


/* 
ee Define REQUEST message fields. 


aggregate REQUEST_MESSAGE structure prefix OPC$ fill; 
REQUEST_FILL byte dimension OPCSK_HDR_SIZE fill; 


/t 
Define place for the trailer message length and text 


REQUEST_LENGTH word unsigned; /* Length of text 
constant REQUEST_MIN_SIZE equals .; /* Min message size 
REQUEST_TEXT Character length 0; /* Start of text 


end REQUEST_MESSAGE; 


/* 
A Define SECURITY message fields. 


aggregate SECURITY_MESSAGE structure prefix OPCS fill; 
SECURITY_FILL byte dimension OPCSK_HDR_SIZE fill; 


/t 

a Define place for the trailer message length and text 
SECURITY_LENGTH word unsigned; /* Length of text 
constant SECURITY_MIN_SIZE equals .; /* Min message size 
SECURITY_TEXT character length 0; /* Start of text 


end SECURITY_MESSAGE; 


/ · 
8 Define REPLY message fields. 


aggregate REPLY_MESSAGE structure prefix OPCS fill; 


tart of oper dev name 
in message size header + 4 


REPLY_FILL byte dimension OPCSK_HDR_SIZE fill; 


/* 
/* After the ASCIC operator device name comes the counted (word 

/* size count) of the reply text. The text does not have to be 

/* present. The address of the —5 and ee ext itself can 

/* be computed at run time. The minimum size is the header, plus 4 
/* for the device and for the count. 

® 


REPLY_OPR character Length 0; /* 
constant REPLY_MIN_SIZE equals .+4 +2; /* 


—— * J 
B 4 


Start of text 
Min message size 


end REPLY_MESSAGE; 
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1 /* es 
38 /* Define STATUS message fields. 
315 si 

18 aggregate STATUS_MESSAGE structure prefix OPCS fill; 
318 
34 

20 /* 
$5; 8 Define place for the operator device name. 
358 STATUS_OPR character Length 0; /* Start of text 
325 constant STATUS_MIN_SIZE equals . + 4; /* Min message size header + 4 
26 
327 


end STATUS_MESSAGE; 
P rege 8 
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/t 
* Define TIMESTAMP message fields. 
® 


WhO 0m 


aggregate TIMESTAMP_MESSAGE structure prefix OPCS fill; 
TIMESTAMP_FILL byte dimension OPCSK_HDR_SIZE fill; 


| 
| 
STATUS_FILL byte dimension OPCSK_HDR_SIZE fill; | 
| 
| 
| 
| 
| 


/t 

- Define the minimum Length, no special fields 

constant TIMESTAMP_MIN_SIZE equals .; /* Min message size 
end TIMESTAMP_MESSAGE; 


/* 
* Define SHUTDOWN message fields 


aggregate SHUTDOWN_MESSAGE structure prefix OPCS fill; 
SHUTDOWN_F ILL byte dimension OPCSK_HDR_SIZE fill; 


WN —O OOBNO UE WhO 0On 


Wn 


/e 
/* Define the minimum length, no special fields 


C 4 
/* 
constant SHUTDOWN_MIN_SIZE equals .; /* Min message size 
end SHUTDOWN_MESSAGE; 
aggregate SHUTDOWN_OPTIONS structure longword unsigned prefix OPCS fill; 


/* 

oe Define request dependent option bits. 
CLUSTER bitfield mask; 

end SHUTDOWN_OPTIONS; 


/* 
8 Define CANCEL message fields 


aggregate CANCEL_MESSAGE structure prefix OPCS fill; 
CANCEL_FILL byte dimension OPCSK_HDR_SIZE fill; 


i: Define the minimum length, no special fields 
constant CANCEL_MIN_SIZE equals .; /* Min message size 
end CANCEL _MESSAGE ; 
aggregate CANCEL_OPTIONS structure longword unsigned prefix OPCS fill; 
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/* 

oe Define request dependent option bits. 
RQSTDONE bitfield mask; 

end CANCEL_OPTIONS; 


end_module OPCDEF TMP; 


wef 
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